home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / TELECOMM / DLRK11 / DLRK11.DOC < prev    next >
Text File  |  1992-09-20  |  8KB  |  159 lines
  1. DOWNLOAD RECORDKEEPER
  2. version 1.1
  3.  
  4. by Allen Brown, CIS 72760,667
  5.  
  6. Before you do anything, make sure you have received the proper
  7. files.  The DLRK11.ZIP you've acquired should contain the following
  8. three files:
  9.  
  10. DLRK11.EXE   --   the program
  11. DLRK11.DNL   --   the data file
  12. DLRK11.DOC   --   the file you're currently reading.
  13.  
  14. Additionally, make sure DLRK11.DNL contains the following three
  15. records only:
  16.  
  17. Download Recordkeeper v1.1
  18. 1
  19. DLRK11.ZIP
  20.  
  21. Download Recordkeeper will not run properly unless DLRK11.DNL
  22. is in the proper form.
  23.  
  24. Now, that that's out of the way......
  25.  
  26. Download Recordkeeper is a simple program to help you keep track
  27. of the files you acquire for your computer system.  The name implies
  28. that such acquisitions be made by downloading from remote systems.
  29. That seems to be the most common method.  But you may use Download
  30. Recordkeeper to keep track of files you acquire by any method, as
  31. you'll soon see.
  32.  
  33. I decided to write the program after I began to download files from
  34. CompuServe and various bulletin board systems.  After I had downloaded
  35. a certain number of files (some of which I kept, and some of which I
  36. discarded), it became more and more difficult to remember right off
  37. the top of my head which files I had already downloaded.  Specifically,
  38. I would be looking through a BBS's list of downloadable files, while
  39. on-line, thinking something like, "Hmmm, that file sounds pretty good.
  40. I think I'll download it," only to discover later that I had already
  41. downloaded the file previously.  Naturally this was pretty frustrating,
  42. especially if I wasted long-distance time or added a debit to my
  43. upload/download ratio by needlessly downloading the same file twice.
  44. Surely I'm not the only one to suffer from such an experience.
  45.  
  46. Of course, many communication programs will allow users to display
  47. a directory of their own files while on-line, and many times I used
  48. this option to try to keep from performing repeat downloads.
  49. However, this course of action can quickly become tiresome if you
  50. have to search through multiple directories.  Furthermore, it is
  51. of no use at all if you have already deleted the first download from
  52. your hard drive.
  53.  
  54. So, after a number of wasteful repeat downloads, I decided to write
  55. Download Recordkeeper.  Like I mentioned above, it's a simple program,
  56. but I think it's comprehensive, effective, and easy to use.  The
  57. program does not interact with any communication program.  It runs
  58. independently.  The user has to input the names of downloaded files
  59. manually.  That fact might disappoint some of you, but I think if
  60. you try the program, you'll see that it's not so bad, and certainly
  61. preferable to the frustration I described two paragraphs above.
  62.  
  63. Running the program is very easy.  DLRK11.DNL must be in the same
  64. directory as DLRK11.EXE, but the program does not have to have its
  65. own directory.  The program first reads DLRK11.DNL which contains
  66. the names of all the files recorded previously.  Then it asks the
  67. user to input the filenames to be added to the list.  It allows
  68. the user to view the contents of the active directory to make it
  69. easier to see which files should be added.  The user also has the
  70. option of selecting a certain extension, limiting the directory
  71. command to that extension only.  The extension options are listed
  72. at the beginning of the program.
  73.  
  74. Hitting <Enter> alone will end the data entry.  The program will then
  75. list all the new entries, if there are any, and ask if the new data
  76. are correct.  If not, it will ask for a record number to change.
  77. It displays the old data and asks the user to input the new data
  78. for that record.  When the user is satisfied that all the data are
  79. correct, the program will then sort the records alphabetically.
  80. This can take a few minutes if there are more than several hundred
  81. records and/or if there are many new entries.  After sorting, the
  82. program will automatically remove any records that have been entered
  83. twice.  Next the program will ask for permission to save the new data.
  84. It does NOT make a backup of the old data file, so be sure you wish
  85. to replace the old file with the new data.  Of course, you can
  86. protect the old data by copying it to another file.
  87.  
  88. Finally, the program will ask to display the data file.  It will not
  89. send the file directly to the printer, but it's an easy matter to
  90. print the file by using the <Print Screen> key.  The file is displayed
  91. with 80 filenames to a screen.  The current date and time are also
  92. displayed so you'll know how old the printout is if you make a hard
  93. copy.  You have the option to quit the program thoughout the data
  94. entry and after each screen is displayed.
  95.  
  96. I decided to designate the maximum number of records to be 3000.
  97. The program will not let the user input more than 3000 records since
  98. that would bomb the program.  I could increase this maximum in a later
  99. version, but 3000 seemed pretty reasonable to me.  Let me know if you
  100. need a higher max, and I'll try to accommodate you.  Also, the
  101. maximum number of new records that the program can handle at one
  102. time is 200.  If you enter 200 filenames during one run, save the
  103. file, quit the program, restart, and enter the remainder.  You can
  104. do this at anytime; for instance, if you've entered 50 or 100 filenames,
  105. it might be wise to save the file and then restart if you need to enter
  106. more.
  107.  
  108. I suggest keeping the program and the datafile in whatever directory
  109. you use to receive new downloads.  That way, you can easily get a
  110. directory containing the new files while you're running the program.
  111. Also, remember to enter any files you acquire that you might be able
  112. to download in the future, whether you keep them or not.
  113.  
  114. After you've got the data file up-to-date, it's a simple matter to
  115. maintain.  Say you download three or four programs from some BBS.
  116. After you quit your terminal program, run Download Recordkeeper,
  117. do a directory, enter the new filenames, and save the new data.
  118. To make the program most effective, keep a hard copy of the data
  119. file at your computer so you can refer to it when you decide to
  120. download files.  The list is in alphabetical order, so it's easy
  121. to find a filename.  In a pinch, you could even run the program
  122. while you're on-line if your terminal program allows you to drop
  123. to a DOS shell.  REMEMBER:  the program will not do you much good
  124. if you do not keep the data file updated!
  125.  
  126. Download Recordkeeper was written in September, 1992, by Allen Brown.
  127. CIS 72760,667.  Prodigy MMMJ81A.  All rights reserved.
  128.  
  129. This humble program is SHAREWARE.  If you keep it and use it, you
  130. are obligated to send $5.00 (a very reasonable price), or more if
  131. you think the program is worth it, to:
  132.  
  133. Allen Brown
  134. P.O. Box 681
  135. Gulf Shores, Alabama  36547
  136.  
  137. This program is presented 'as is.'  The author will not assume
  138. responsibility for any data mishaps.  Feel free to send comments,
  139. suggestions, or bug reports.  Registered users who donate at least
  140. $5.00 will receive notice of program updates.  Please include your
  141. CompuServe or Prodigy ID numbers if you subscribe to either.
  142.  
  143. Feel free to upload DLRK11.ZIP to any BBS you like.  Just make
  144. sure it contains the original files.  The original DLRK11.DNL
  145. is described at the top of this document.  Please be sure to
  146. include the original DLRK11.DNL and not your own modified file.
  147. If you do not include the original DLRK11.DNL, anyone who acquires
  148. your upload might run into trouble, especially if they don't read
  149. DLRK11.DOC.  Also, please do not upload Download Recordkeeper without
  150. including this documentation.
  151.  
  152. Download Recordkeeper was written with MS QuickBasic 4.5.  I hope
  153. Download Recordkeeper proves useful to you.  It works great for me.
  154.  
  155. Thanks for supporting the shareware concept!  Only you can make
  156. shareware work!
  157.  
  158. THE END
  159.